PATH Mac OS 8 and 9 Developer Documentation > Text and Other International Services > Apple Type Services for Unicode Imaging (ATSUI) > Apple Type Services for Unicode Imaging Reference

ATSUGetFontFeature

Obtains the font feature type and selector for an indexed font feature.

OSStatus ATSUGetFontFeature ( ATSUStyle iStyle, ItemCount iFeatureIndex, ATSUFontFeatureType *oFeatureType, ATSUFontFeatureSelector *oFeatureSelector);

iStyle: A reference of type ATSUStyle. Pass a reference to a valid style object whose font feature value you want to obtain. You cannot pass NULL for this parameter.
iFeatureIndex: A 0-based index. Pass a value between 0 and one less than the value passed back in the oActualFeatureCount parameter of the function ATSUGetAllFontFeatures.
oFeatureType: A pointer to a value of type ATSUFontFeatureType or one of the font feature types described in Font Feature Type Constants. On return, the font feature type corresponding to iFeatureIndex. If the font feature type has not been set, ATSUGetFontFeature passes back the font-specified default value and returns the result code kATSUNotSetErr.
oFeatureSelector: A pointer to a value of type ATSUFontFeatureSelector or one of the font feature selector constants described in Apple Advanced Typography Constants. On return, the font feature selector. If the feature selector value has not been set, ATSUGetFontFeature passes back the font-specified default value and returns the result code kATSUNotSetErr.
function result: A result code. See Result Codes.

DISCUSSION

Before calling the ATSUGetFontFeature function, call the function ATSUGetAllFontFeatures to obtain an array of all the feature types and selectors that were previously set for a particular style object. To determine the font feature type and selector for a given indexed font, pass a value between 0 and one less than the value passed back in the oActualFeatureCount parameter of ATSUGetAllFontFeatures in the iFeatureIndex parameter of ATSUGetFontFeature.

VERSION NOTES

Available beginning with ATSUI 1.0.